home *** CD-ROM | disk | FTP | other *** search
/ The PC-SIG Library 10 / The PC-Sig Library - Shareware for the IBM PC and Compatibles (PC-SIG)(Tenth Edition Disks 1-2804)(1991).iso / PC_SIGCD / 22 / 4 / DISK2247.ZIP / CBASE101.ZIP / CBASE.ZIP / CBLOCK.C < prev    next >
Text File  |  1990-06-21  |  5KB  |  196 lines
  1. /*    Copyright (c) 1989 Citadel    */
  2. /*       All Rights Reserved        */
  3.  
  4. /* #ident    "@(#)cblock.c    1.4 - 90/06/20" */
  5.  
  6. /* ansi headers */
  7. #include <errno.h>
  8.  
  9. /* library headers */
  10. #include <btree.h>
  11. #include <lseq.h>
  12.  
  13. /* local headers */
  14. #include "cbase_.h"
  15.  
  16. /*man---------------------------------------------------------------------------
  17. NAME
  18.      cblock - lock cbase
  19.  
  20. SYNOPSIS
  21.      #include <cbase.h>
  22.  
  23.      int cblock(cbp, ltype)
  24.      cbase_t *cbp;
  25.      int ltype;
  26.  
  27. DESCRIPTION
  28.      The cblock function controls the lock status of a cbase.  The cbp
  29.      argument is an open cbase.  ltype indicates the target status of
  30.      the lock on the cbase.
  31.  
  32.      The lock types available are:
  33.  
  34.      CB_UNLCK       unlock cbase
  35.      CB_RDLCK       lock cbase for reading
  36.      CB_WRLCK       lock cbase for reading and writing
  37.      CB_RDLKW       lock cbase for reading (wait)
  38.      CB_WRLKW       lock cbase for reading and writing (wait)
  39.  
  40.      For the lock types which wait, cblock will not return until the
  41.      lock is available.  For the lock types which do not wait, if the
  42.      lock is unavailable because of a lock held by another process  a
  43.      value of -1 is returned and errno set to EAGAIN.
  44.  
  45.      cblock will fail if one or more of the following is true:
  46.  
  47.      [EAGAIN]       ltype is CB_RDLCK and the cbase is
  48.                     already write locked by another process,
  49.                     or ltype is CB_WRLCK and the cbase is
  50.                     already read or write locked by another
  51.                     process.
  52.      [EINVAL]       cbp is is not a valid cbase.
  53.      [EINVAL]       ltype is not a valid lock type.
  54.      [CBECORRUPT]   Either the record file or one of the index
  55.                     files of cbp is corrupt.
  56.      [CBENOPEN]     cbp is not open.
  57.      [CBENOPEN]     ltype is CB_RDLCK or CB_RDLKW and cbp
  58.                     is not opened for reading or ltype is
  59.                     CB_WRLCK or CB_WRLKW and cbp not open
  60.                     for writing.
  61.  
  62. SEE ALSO
  63.      cbgetlck.
  64.  
  65. DIAGNOSTICS
  66.      Upon successful completion, a value of 0 is returned.  Otherwise,
  67.      a value of -1 is returned, and errno set to indicate the error.
  68.  
  69. ------------------------------------------------------------------------------*/
  70. int cblock(cbp, ltype)
  71. cbase_t *cbp;
  72. int ltype;
  73. {
  74.     int    btltype    = 0;        /* btree lock type */
  75.     int    i    = 0;        /* loop counter */
  76.     int    lsltype    = 0;        /* lseq lock type */
  77.  
  78.     /* validate arguments */
  79.     if (!cb_valid(cbp)) {
  80.         errno = EINVAL;
  81.         return -1;
  82.     }
  83.  
  84.     /* check if cbase not open */
  85.     if (!(cbp->flags & CBOPEN)) {
  86.         errno = CBENOPEN;
  87.         return -1;
  88.     }
  89.  
  90.     /* check open flags and set lsltype and btltype */
  91.     switch (ltype) {
  92.     case CB_RDLCK:
  93.         if (!(cbp->flags & CBREAD)) {
  94.             errno = CBENOPEN;
  95.             return -1;
  96.         }
  97.         lsltype = LS_RDLCK;
  98.         btltype = BT_RDLCK;
  99.         break;
  100.     case CB_RDLKW:
  101.         if (!(cbp->flags & CBREAD)) {
  102.             errno = CBENOPEN;
  103.             return -1;
  104.         }
  105.         lsltype = LS_RDLKW;
  106.         btltype = BT_RDLKW;
  107.         break;
  108.     case CB_WRLCK:
  109.         if (!(cbp->flags & CBWRITE)) {
  110.             errno = CBENOPEN;
  111.             return -1;
  112.         }
  113.         lsltype = LS_WRLCK;
  114.         btltype = BT_WRLCK;
  115.         break;
  116.     case CB_WRLKW:
  117.         if (!(cbp->flags & CBWRITE)) {
  118.             errno = CBENOPEN;
  119.             return -1;
  120.         }
  121.         lsltype = LS_WRLKW;
  122.         btltype = BT_WRLKW;
  123.         break;
  124.     case CB_UNLCK:
  125.         lsltype = LS_UNLCK;
  126.         btltype = BT_UNLCK;
  127.         break;
  128.     default:
  129.         errno = EINVAL;
  130.         return -1;
  131.         break;
  132.     }
  133.  
  134.     /* unlock in reverse order of locking */
  135.     if (ltype == CB_UNLCK) {
  136.         /* unlock index files */
  137.         for (i = cbp->fldc - 1; i >= 0; --i) {
  138.             if (cbp->fldv[i].flags & CB_FKEY) {
  139.                 if (btlock(cbp->btpv[i], btltype) == -1) {
  140.                     CBEPRINT;
  141.                     return -1;
  142.                 }
  143.             }
  144.         }
  145.     }
  146.  
  147.     /* lock data file */
  148.     if (lslock(cbp->lsp, lsltype) == -1) {
  149.         if (errno == EAGAIN) {
  150.             return -1;
  151.         }
  152.         if (errno == LSECORRUPT) {
  153.             errno = CBECORRUPT;
  154.             return -1;
  155.         }
  156.         CBEPRINT;
  157.         return -1;
  158.     }
  159.  
  160.     if (ltype != CB_UNLCK) {
  161.         /* lock index files */
  162.         for (i = 0; i < cbp->fldc; ++i) {
  163.             if (cbp->fldv[i].flags & CB_FKEY) {
  164.                 if (btlock(cbp->btpv[i], btltype) == -1) {
  165.                     CBEPRINT;
  166.                     return -1;
  167.                 }
  168.             }
  169.         }
  170.     }
  171.  
  172.     /* set lock bits */
  173.     switch (ltype) {
  174.     case CB_RDLCK:
  175.     case CB_RDLKW:
  176.         cbp->flags |= CBRDLCK;
  177.         cbp->flags &= ~CBWRLCK;
  178.         break;
  179.     case CB_WRLCK:
  180.     case CB_WRLKW:
  181.         cbp->flags |= (CBRDLCK | CBWRLCK);
  182.         break;
  183.     case CB_UNLCK:
  184.         cbp->flags &= ~CBLOCKS;
  185.         break;
  186.     default:
  187.         CBEPRINT;
  188.         errno = CBEPANIC;
  189.         return -1;
  190.         break;
  191.     }
  192.  
  193.     errno = 0;
  194.     return 0;
  195. }
  196.